home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
BBS Toolkit
/
BBS Toolkit.iso
/
qbbs
/
ques_221.zip
/
QUESDOOR.DOC
next >
Wrap
Text File
|
1991-04-15
|
111KB
|
3,211 lines
Ra 1.0 and up ▄▄▄ ▄ ▄ ▄▄▄▄▄ ▄▄▄▄ ▄ ▄ ▄▄▄ ▄▄▄▄ ▄▄▄
╔══════════════█▄▄ ▀▄▀ █ █▄▄ █▀▄ █ █ █ █▄▄ █ █═════════════╗
║ ░░░░░░░░░ █▄▄▄ █ █ █ █▄▄▄ █ ▀█ █▄▄▀ █▄▄▄ █▄▄▀ ║
║ ░░ ░░ ║
║ ░░ ░░ (tm) ║
║ ░░ ░░ ░░ ░░ ░░░░░░░ ░░░░░░░ ░░░░░░ ░░░░░░░ ░░░░░░░ ░░░░░░░ ║
║ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ║
║ ░░ ░░ ░░ ░░ ░░░░░ ░░░░░░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░░░░░░ ║
║ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ░░ ║
║ ░░░░░░░░░ ░░░░░░░ ░░░░░░░ ░░░░░░░ ░░░░░░ ░░░░░░░ ░░░░░░░ ░░ ░░ ║
║ ░░ ║
║ An Extended Questionnaire Command Language Door ║
║ For RemoteAccess V 2.20 ║
╚═══════════════════════════════════════════════════════════════════╝
Copyright (c) Ron Huiskes and Intersoft 1990-91
All rights reserved
The QUESDOOR support board is:
InterFace HeadQuarters Europe
p.o. Box 528
2280 AM Rijswijk ZH
The Netherlands
+31-70-3361380 / +31-70-3361381
Matrix: [2:281/506]
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 1
TABLE OF CONTENTS
-----------------
1. Disclaimer and legal matters.........................
Legal terms.......................................... 3
License information.................................. 3
Registering.......................................... 4
2. Introduction.........................................
What is Quesdoor ?................................... 5
Installing and behaviour............................. 5
Command language..................................... 6
Tips................................................. 6
3. Input commands.......................................
Ask.................................................. 8
AskEdit.............................................. 8
AskForced............................................ 8
AskCount............................................. 9
AskNumber............................................ 9
AskDate.............................................. 9
GetChar.............................................. 10
GetChoice............................................ 10
4. Output commands to screen............................
ChangeColor.......................................... 10
ClearScreen.......................................... 11
Display.............................................. 11
DisplayFile.......................................... 11
DisplayAnyFile....................................... 12
ListAnswer........................................... 12
ListSecurity......................................... 12
ListTimeLeft......................................... 12
ListFlags............................................ 13
Output............................................... 13
5. Output commands to file/disk.........................
Delete............................................... 14
PostInfo............................................. 14
Output............................................... 13
OutputAnswer......................................... 14
OutputLog............................................ 15
6. Setting commands.....................................
Random............................................... 15
SetDataPhone......................................... 15
SetFlag.............................................. 15
SetHomePhone......................................... 16
SetLevel............................................. 16
SetParam............................................. 16
SetSecurity.......................................... 17
SetTime.............................................. 17
SetVar............................................... 17
Toggleflag........................................... 18
7. Aritmethic commands..................................
Addvar............................................... 18
Mulvar............................................... 18
Subvar............................................... 18
Divvar............................................... 19
Pastevar............................................. 19
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 2
8. Procedure commands...................................
Labels............................................... 20
Gotolabel............................................ 20
Gosublabel........................................... 20
Start................................................ 20
9. Decision-Making commands.............................
EndIf................................................ 21
EndNotIf............................................. 21
If................................................... 21
IfNot................................................ 22
10. Global commands......................................
CheckPhone........................................... 22
Readflag............................................. 23
Readsecurity......................................... 23
Readansi............................................. 24
11. Database commands....................................
WriteData............................................ 25
LoadData............................................. 25
CheckData............................................ 26
11. Voting commands......................................
Votedoor concept..................................... 27
AskQuestion.......................................... 27
ShowAnswer........................................... 27
ShowQuestion......................................... 28
VoteQuestion......................................... 28
12. Timebank commands....................................
Timebank concept..................................... 30
BorrowTime........................................... 30
BuyTicket............................................ 30
DeposTime............................................ 31
RedrawTime........................................... 31
Robbank.............................................. 31
ShowAccount.......................................... 32
ShowClients.......................................... 32
TransTime............................................ 32
Ed_bank.Exe.......................................... 33
13. Misc. commands.......................................
Beep................................................. 34
Halt................................................. 34
Pause................................................ 34
Quit................................................. 34
Run / Exec .......................................... 34
14. Appendices...........................................
Appendix A: Control codes............................ 35
Appendix B: Let commands............................. 39
Appendix C: Index.................................... 42
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 3
Legal Terms
-----------
Ron Huiskes and InterSoft hereby excludes all warranties
relating to this software and documentation, whether express
or implied, including, without limitation, any implied
warranties of merchantability and/or fitness for a particular
purpose.
Ron Huiskes and InterSoft shall not be liable for any
damages, whether direct, indirect, special, incidental, or
consequential, resulting from the use of this software and
documentation, due to loss of data or any other reason.
In no event shall Ron Huiskes and InterSoft's liability for
any damages ever exceed the price paid to InterSoft for the
license to use this software, regardless of the form of the
claim.
The person using this software bears all risk as to its
quality and performance.
License information
-------------------
"Quesdoor" refers to the executable program and
documentation contained in Quesdoor's software distribution
archives released by InterSoft.
1. Quesdoor is the copyrighted material of InterSoft. It may
only be used in agreement with the conditions set out in
this license agreement.
2. You may use Quesdoor for a period of three weeks on a
trial basis in order to determine it's suitability for
your particular application. After this period you MUST
register each copy of Quesdoor that you run simultaneously.
Multi-line installations that share a common file base AND
have the same name need only register one copy.
3. Registration entitles you to use Quesdoor and any future
versions of Quesdoor for as long as you wish, subject to
any special licensing conditions attached to future
versions. For details on the registration procedure, refer
to the section in this document "Registering".
4. InterSoft is in no way obligated to provide future
versions of, or support for, Quesdoor. Whether future
versions will be developed depends upon the number of
registrations received for this version.
5. Site and Group registrations are available, and are dealt
with on a case by case basis.
6. You may not modify or otherwise reverse-engineer Quesdoor.
7. You are encouraged to distribute Quesdoor provided that no
fee is charged for its distribution, and that the
distribution archive is not modified in any way. Pay
Bulletin Board Systems may however charge their normal fee
provided that no additional change for Quesdoor is levied.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 4
8. Quesdoor may not be included as part of any software
library which is distributed on a commercial basis without
prior written permission from InterSoft.
9. Quesdoor may not be used in any unlawful or illegal
manner.
Registering
-----------
The registration fee for Quesdoor is Dfl 25.- (twenty five
Dutch guilders).
Holland: Any method of payment is accepted, either cash, giro,
postal money order, check or girotel.
Europe: Either cash (registered letter) or Eurocheque written
out in Dutch currency.
Others: Contact our US registration site:
Scott Livingston Stone Henge BBS
290F Brittany Farms Rd 203-826-1153
New Britain, CT 06053
U.S.A.
Print or reproduce the registration form supplied in the
distribution archive and send it with your registration
payment to:
InterSoft/Quesdoor
p.o. Box 528
2280 AM Rijswijk ZH
The Netherlands
Upon registering you will receive your uniquely generated
key. Each key is a small file which contains a serial number.
To install the key, simply rename it (if necessary) to
QUESDOOR.KEY and copy it to your RemoteAccess system
directory or the directory where the message base resist.
This serial number is unique, and under NO circumstances
should it be made available to anyone else. Doing so is a
direct violation of the agreement you entered into with us by
registering.
When Quesdoor detects a valid key it switches into
registered mode, and will show so at the end of an Quesdoor
session. (Instead of the big add at the end, it will display
'QUESDOOR v2.0+ by R. Huiskes', a very discreet way of
showing your users you registered your copy of Quesdoor.)
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 5
What is Quesdoor?
----------------
Quesdoor is a RA door with a flexible script language. The
script language allows you to write your own doors in very
less time. The script language is fully compatible with the
language Ra uses, so all your existing questionairs can be
run without a problem with Quesdoor.
Quesdoor has at this moment around 50 extra enhanced
commands to this script language, which will make your
questionairs much more attractive. The enhanced commands are
easy to learn and understand.
Even though the command language is easy to understand, if
you can't write a correct batchfile, this program will
probably no good for you.
Installing and Behaviour
------------------------
Quesdoor is a full RA compatible Door. It has built in
carrier detect routines, and smart fossil and timer
functions. There is no need for an external watchdog or
redirect program. Locked baudrates are no problem.
Quesdoor has build in record and file locking routines
and will need share.exe when the Multiline bit in Raconfig is
enabled.
Quesdoor also has a build in Ansi driver. Ansi.sys is not
required to operate locally. The local site looks almost the
same as Ra, with the same status column and function keys.
Alt function keys are also their, just press alt-c for chatmode,
alt-l to lock out a user forever, alt-h to hangup and alt-n for
sysop next.
Quesdoor reads questionnaires... A questionnaire is a plain
ascii file with on every line a valid command. The command
interpreter is case sensitive, so "ask" is the same as "ASK".
If Quesdoor encounters an invalid command, it beeps and gives
you the exact error and line number where the mistake was found.
Creating a questionnaire is not so easy, and you should
carefully plan what you are going to do, before you even start
your editor. Making a questionnaire is much like programming,
every mistake you make will be directly involve the performance
of Quesdoor.
Quesdoor will use a lot of Ra's specific files, and
therefore it is NOT possible to run Quesdoor on other bbs
systems. Quesdoor will find all these files through the
paths you set in config.ra. Config.ra itself can be in the
dir you invoke Quesdoor from, or in the dir where your Ra
environment variable points to. (that is usually the case).
The questionnaire(s) itself (Which have the extension .q-a)
can be in any directory as long as you specify the complete
path to that questionnaire.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 6
Quesdoor can be run as a type 7 or 15, depending on your
needs and free memory. Quesdoor uses around the 140 K of
memory.
Installing Quesdoor in Ra is easy. Just use a type 7 menu-
command with in the optional datafield:
<path to>QUESDOOR.EXE [<path to>.Q-A name].
By default quesdoor uses 'QUESDOOR.Q-A' as questionnaire name,
but if you want to use your own name or if you have more than
one questionnaire you like to run from quesdoor, you can use any
legal dos name.
Quesdoor.exe NewUser" will start the newuser questionnaire,
and "Quesdoor.exe Menu" starts the menu questionnaire, provided
that they exist.
Command Language
----------------
The command language Quesdoor uses is fully compatible with
the questionnaire language RemoteAccess uses. Most of these
commands have enhanced functions which will be explained in
the next chapters.
These enhanced commands will give you the ability to
program almost everything you like, including time gamble
games, a blackjack game, a voting door and a complete
timebank. (samples are included).
The command language will be enhanced with every new
version of Quesdoor, and if you have an idea for a command,
just tell us...
To make it easy for you when writing Questionnaires, Quesdoor
can be started from Dos, without loggin in to your bbs!
Just place a '/L' after the questionnaire name on the command
line, and Quesdoor will create two temporary Raccess files
(dorinfo1.def and exitinfo.bbs) which enables you to start
the questionnaire.
TIPS
----
Specifying a '/L' on the command line will let you test
out Questionnaires from Dos. Never use this in a menu command.
Specifying a '/E' on the command line will disable ANY error
message. Useful when you install your 100% perfect questionnaire
in Ra, and you don't want to see the internal messages from
Quesdoor at start.
The error messages can also be set on or off with a special
command to use in the questionnaire itself. (see LET commands).
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 7
In order to program a good questionnaire, here are some points
to take care of:
■ First make sure you know all the commands which you can
use globally. There are many commands that look-a-like,
and do almost the same thing. Make sure you know the
differents.
■ Make sure that on every line of the questionnaire there
is only one valid command, they may start on every column
you wish.
■ Leave comments in your questionnaires (starting with ';' on
every line) so that even after a year you still now what
and why you did something.
■ Try out a questionnaire several times from Dos before you
bring it online.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 8
In the next couple of chapters we will express every command
that is legal to use in Quesdoor's interpreter. We'll start
with all the input routines that are possible....
The command: ASK
----------------
Syntax: Ask <Len> <Var num>
Example : Display "What is your name ?"
Ask 15 3
This command waits for the user to input a string that is up
to 15 characters long (in this example), and stores the
string in the variable number 3 (also in this example). Valid
values for <Len> are 0 to 255. <Var num> may be any number
between 1 and 40. If <Len> is 0 only [ENTER] is a valid
response, and the contents of <Var num> will be empty.
The command: ASKEDIT
--------------------
Syntax: Askedit <Len> <var num>
Example: Display "What is your name ?"
Askedit 15 3
This command is almost the same as the ASK command. When this
command is used, first the contents of <var num> will be shown,
and then the user gets the change to edit this contents (with
the backspace key to delete chars). If the contents of <var num>
was empty before the command was executed, the ASKEDIT command
reacts the same as the ASK command.
When you use this example in some kind of registration door it is
most likely that Quesdoor already knows the name of the user, and
it looks better if Quesdoor could give the user the change to edit
his name (or just press enter if correct) instead of filling it in
for a second time (when he logged on it was the first thing he had
to fill in.) To bring the name of the user in variable number 3 you
can use the SETVAR command. In this example it was
better to begin the questionnaire with: SETVAR 3 = A. This will
fill variable number 3 with the users full name. (see the control
codes section and setvar section further in this doc)
The command: ASKFORCED
----------------------
Syntax: Askforced <min length> <max length> <var num>
Example : Display "What is your name ?"
Askforced 2 35 1
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 9
This command waits for the user to input a string that is up
to 35 characters (in this example), and at least 2 characters.
In this example the user cannot press enter/return before he
inputs at least 1 character. The input string will be stored
in variable number 1.
The command: ASKCOUNT
---------------------
Syntax: Askcount <min length> <max length> <var num>
Example: Display "Enter your telephone number:"
Askcount 10 15 2
This command will let the user only input integers 0 'till 9
and '-', '(' and ')'. You can specify exactly how long the
input field may be, including minimum and maximum length. The
contents of the input field will be stored in variable number
2 (in this example).
The command: ASKNUMBER
----------------------
Syntax: Asknumber <minimal value> <maximum value> <var num>
Example: Display "Enter your age:"
Asknumber 5 99 1
The asknumber command is completely different from the askcount
command. This command needs an number from the user as input,
and you can supply the range. In the above example the user is
asked about his age. Quesdoor will refuse any input below 5 or
above 99. It simply beeps and refuses to continue. You must make
sure that you let the user know what the range is. (In the above
example it's obvious, if a 4 year old kid, or someone with age
101 starts calling your board you can better call it ghost bbs)
The command: ASKDATE
--------------------
Syntax: AskDate <var num>
Example: Askdate 2
With this command, the user is expected to enter a date. Quesdoor
will beep and refuse to continue (the enter key) when the date
is invalid.
The <var num> will be filled with the date the user entered.
As default Quesdoor uses the DD/MM/YY (european) date form, but
with the 'LET DATEFORM' command you can set other forms... See
appendix B for more info on the Let command.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 10
The command: GETCHAR
--------------------
Syntax: Getchar [Var num]
Example : Display "Enter your choice: "
Getchar 2
This command waits for the input of ONE character and
optionally stores the character in var num 2 (in this
example). This command is different from the Getchoice
command below that with this any input character is valid.
Also this command differs from the Ask command because with
this, no enter is expected from the input site.
The command: GETCHOICE
----------------------
Syntax: GetChoice <Valid choices> [Var num]
Example : Display "Are you sure ? (Y/N) "
GetChoice YN 2
Waits for the user to enter one of the characters in <Valid
choices>, and optionally stores the response in the variable
[Var num]. If [Var num] is not specified, the response will
not be stored.
The command: CHANGECOLOR
------------------------
Syntax: ChangeColor <Foreground> [Background]
Example : ChangeColor 7 1
Changes the colour of the text if the user has ANSI graphics
enabled. [Background] is optional, and defaults to 0. Valid
colours are:
<Foreground> [Background]
------------ ------------
0 Black 0 Black
1 Blue 1 Blue
2 Green 2 Green
3 Cyan 3 Cyan
4 Red 4 Red
5 Magenta 5 Magenta
6 Brown 6 Brown
7 Light Grey 7 Light Grey
8 Dark Grey
9 Light Blue
10 Light Green
11 Light Cyan
12 Light Red
13 Light Magenta
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 11
14 Yellow
15 White
The command: CLEARSCREEN
-------------------------
Syntax: ClearScreen
Example : ClearScreen
This command clears the screen on the users and local side
provided that the user has screen clearing enabled.
The command: DISPLAY
--------------------
Syntax: Display "<Text> [|]"
Display <var num>[L/R<fixed length>]
Example 1: Display "Please answer ALL questions|"
Displays the specified text between the quotes on the screen.
The optional vertical bar is translated to a line-feed and
carriage return. If this bar is omitted, any following text
starts at the next character on the same line.
Example 2: Display 7
Displays the contents of variable number 7 (in this example)
on the screen.
Example 3: Display 7L10
Presume the contents of var 7 is "Ron", with the above example
"Ron " is shown.
Example 4: Display 7R10
Presume the contents of var 7 is "Ron", with the above example
" Ron" is shown.
The command: DISPLAYFILE
------------------------
Syntax: DisplayFile <1-8 character file name>
DisplayFile #<var num>
Example : DisplayFile BBSRULES
Causes a text file to be displayed in the same way as a menu
type 5 would be displayed in Ra. The text file must be in the
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 12
text file directory specified in Config.ra, and it must have
the extension .ASC/.ANS. In the text file all sort of control
codes may be used. See appendix B for a list of all useable
control codes.
When using the #<var num> as filename, the <var num> must contain
a legal dos name.
The command: DISPLAYANYFILE
---------------------------
Syntax: DisplayAnyFile <complete path + filename> or
DisplayAnyFile #<var num>
Example: DisplayAnyFile c:\txtfiles\welcome.asc
With this command you can display any file you which, anywhere
on your disk. The difference with the displayfile command is,
that with the displayfile command all the files to be displayed
must be in the textfile dir as supplied in raconfig. With this
command any file is possible.
If you use the displayanyfile #<var num> syntax, Quesdoor expects
to find a legal dos filename as contents of that <var num>.
The command: LISTANSWER
-----------------------
Syntax: ListAnswer <Var num>
Example : ListAnswer 5
Displays (to the screen) the contents of the variable
<Var num> followed by a CR/LF.
The command: LISTSECURITY
-------------------------
Syntax: ListSecurity
Example : Display "Your security level is: "
Listsecurity
Displays (to the screen) the users security level.
The command: LISTTIMELEFT
-------------------------
Syntax: ListTimeLeft
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 13
Example : Display "Your time remaining is: "
ListTimeLeft
Display " minutes.|"
Displays (to the screen) the users time remaining for this call.
The command: LISTFLAGS
----------------------
Syntax: Listflags <flagset> or
Listflags All
Example: Display "Your A3 is now set to: "
Listflags A3
This command will display 'ON' or 'OFF' according to the users
flag setting. When the keyword ALL is used, all the users flags
will be displayed (on one line).
The command: OUTPUT
-------------------
Syntax: Output "<Descriptor> [#<var num>[L/R<fixed length>]]"
[filename.ext]
Output is a very powerful command! It will send the text
between the " " to the screen, or if you specify a filename
at the end, it will send the text to a filename.
Example 1: OUTPUT "hello"
This will display 'hello' to the screen.
Example 2: OUTPUT "hello" QUESDOOR.ASW
This will write the line 'hello' to the filename quesdoor.asw.
Within the " " you can use variable numbers, as long as you
start that variable number with a #, and end it with a space.
Example 3: OUTPUT "hello #1 how are you doing ?"
This will echo 'hello Ron how are you doing ?' to the screen,
provided that the contents of var num 1 is 'Ron'.
If you want, you can preformat the length of the variable to
a specific length when you specify the length right after the
variable number. Also you then have to specify how your
variable contents has to be formatted: To the Left or to Right.
Example 4: OUTPUT "hello #1L10 how are you doing ?"
This will echo 'hello Ron how are you doing ?' to the
screen, provided that the contents of var num 1 is 'Ron'.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 14
Example 5: OUTPUT "hello #1R10 how are you doing ?"
This will echo 'hello Ron how are you doing ?' to the
screen, also provided that the contents of var num 1 is 'Ron'.
The command: DELETE
-------------------
Syntax: Delete <filename>
Example : Delete new.asw
Deletes a file on disk in the current dir. If the file does
not exist there will be an error message displayed (only) on
the local console. This command is useful when you want to
delete the filename.ASW file which is automaticly created on
quesdoor's start.
The command: POSTINFO
---------------------
Syntax: PostInfo
Example : PostInfo
Outputs the user's name and date and time to the answer file.
This command is useful in your newuser questionnaire, before
the actual answers from the user are printed.
Some programs use the output of this command (starting with
**) to find the answers of one particular user.
The command: OUTPUTANSWER
-------------------------
Syntax: OutputAnswer "<Descriptor>" [Var num]
Example : OutputAnswer "Hobbies : " 6
Outputs <Descriptor> optionally followed by the contents
of the variable <Var num> to the questionnaire answer file.
The answer file is given the same name as the questionnaire
file but has an extension of .ASW.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 15
The command: OUTPUTLOG
----------------------
Syntax: OutPutLog "<String>"
Example : Outputlog "Just entered quesdoor!"
The Outputlog command prints <String> in the Ra logfile in
the current dir (in Frontdoor style). If quesdoor cannot
find the logfile, a new logfile will be created.
The command: RANDOM
-------------------
Syntax: Random <Max value> <Var Num>
Example : Random 10 1
In the above example, the variable number 1 is filled with
a random number between 1 and 10. Nice for a small guess
game...
The command: SETDATAPHONE
-------------------------
Syntax: SetDataphone <Var num>
Example : Setdataphone 2
Stores the contents of <var num> into the dataphone data field
of users.bbs. If the contents of <var num> is longer than 12
characters, it will be truncated to 12 characters. (But better
is to make sure users can't fill in a longer phonenumber than 12
characters).
The command: SETFLAG
--------------------
Syntax: SetFlag <Flag set><Flag number> <ON|OFF>
Example : SetFlag C3 OFF
Turns a specified user flag on or off. <Flag set> is "A",
"B", "C" or "D", and <Flag number> is a number between one and
eight.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 16
The command: SETHOMEPHONE
-------------------------
Syntax: SetHomephone <Var num>
Example : Sethomephone 2
Stores the contents of <var num> into the homephone data field
of users.bbs. If the contents of <var num> is longer than 12
characters, it will be truncated to 12 characters. (But better
is to make sure users can't fill in a longer phonenumber than 12
characters).
The command: SETLEVEL
---------------------
Syntax: SetLevel <var num>
Example : Setlevel 1
Simply sets the user's security level to the contents of
variable number one (in this example). If the contents of
<var num> cannot be converted to a user's security level
(for example if the contents of <var num> contain letters)
then the security level will remain the same.
The command: SETPARAM
---------------------
Syntax: SetParam <param num> <Var num>
Example : SetParam 1 10
The above example stores the first parameter given at the
start of Quesdoor in variable number 10. So, if you started
Quesdoor like 'Quesdoor.exe test' to start the test
questionnaire, and you use above example, after the command
is executed, variable number 10 will have 'test' as contents.
Of course you could supply extra parameters, like the *1
which Ra replaces with the current message template number,
or just any number or word. If you start Quesdoor like
'Quesdoor.exe test *1' with a type 7 in RA, after executing
the command 'SetParam 2 10' in the test questionnaire, variable
number 10 will contain the current message template area number.
Note: *1 is a new type 7 command-line parameter, it will be
replaced by RA to the current message template area
number.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 17
The command: SETSECURITY
------------------------
Syntax: SetSecurity [+/-]<Security level>
Example 1: SetSecurity 10
When this command is used, it will set the user's security
level to the number specified. (In this example, the level
will be set to 10). The level may be any number from 0 to
32,000.
Example 2: SetSecurity +1
If a user had level 100, his level will be 101 after this
command is executed. If a user had level 10, his level
will be 11.
The same counts for "Setsecurity -10", if a user had level
100, he now has level 90. If he had level 10, he will now
have level 1. (this command is programmed not to go below
level 1, if you want level 0 use "Setsecurity 0")
The command: SETTIME
--------------------
Syntax: SetTime <+/-><minutes>
Example : Settime +10
Above example increases the time left with 10 minutes. If
a '-' is supplied before <minutes> the time is decreased.
The +/- are not optional ! You have to supply either one
of them !
The command: SETVAR
-------------------
Syntax: SetVar <Var num> = "<String>"
SetVar <Var num> = <Ext. control code>
Example 1: Setvar 2 = "hello"
When this command is used, the <String> will be stored into
variable number 2.
Example 2: Setvar 2 = ^FA
When this is used, Quesdoor will store the users full name
into the variable number 2. See appendix B for a complete
list of all the extended control codes which you can use.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 18
The command: TOGGLEFLAG
-----------------------
Syntax: ToggleFlag <Flag set><Flag number>
Example : Setflag C3
This command will toggle the users flag setting. If in the
example the user's C3 flag was ON, it will be toggled OFF,
and if it was OFF, it will be ON after this command is
executed. It just toggles the mentioned flag to the opposite.
The command: ADDVAR
-------------------
Syntax: Addvar <var1> <var2> [var3]
Example : Addvar 1 2 3
Only if the contents of the variable numbers are numbers
(integers) this declaration is valid. The above example
adds the contains of variable number 1 with variable number
2, and stores the result in variable number 3. So, if
<var1> = 1 and <var2> = 3, after the command "Addvar 1 2 3"
<var3> will have the value 4. If you don't supply the third
variable, the result will be stored in variable number one.
The command: MULVAR
-------------------
Syntax: Mulvar <var1> <var2> [var3]
Example : Mulvar 1 2 3
Only if both variable numbers contain numbers this declaration
is valid. The above example multiplies the contains of
variable number 1 with variable number 2, and stores the
result in variable number 3. If you don't supply the third
variable, the result will be stored in variable number one.
The command: SUBVAR
-------------------
Syntax: Subvar <var1> <var2> [var3]
Example : Subvar 1 2 3
Only if both variable numbers contain numbers this declaration
is valid. The above example subtracts the contains of
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 19
variable number 1 with variable number 2, and stores the result
in variable number 3. If you don't supply the third variable,
the result will be stored in variable number one.
The command: DIVVAR
-------------------
Syntax: Divvar <var1> <var2> [var3]
Example : Divvar 1 2 3
Only if both variable numbers contain numbers this declaration
is valid. The above example divides varnum2 through varnum1 and
stores the result in variable number 3. IF you don't supply the
third variable, the result will be stored in variable number one.
The command: PASTVAR
--------------------
Syntax: Pastvar <var1> <var2> [var3]
Example: Pastvar 1 2 3
Pastvar paste the contents of two variables together.
Assume var1 has 'c:\files\' as contents, and var2 has 'top.ans'
as contents. After using the above example var3 will have
'c:\files\top.ans' as new contents.
If you don't supply the third variable, the result will be stored
in variable number one.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 20
Labels
------
One of the best things in Quesdoor is the ability to use
labels, almost exactly as you can do in batch files. Together
with the gotolabel and gosublabel command, it gives you a very
flexible way of programming your questionairs !
An label declaration must begin with a ':' and the name must
have at least a length of 4 characters. (only the first three
characters are sensitive, you may use longer label names, but
Quesdoor looks only to the first three.) An label declaration
ends with just a ':'.
Example: :Top
display "this is the top label"
:
The command: GOTOLABEL
----------------------
Syntax: GotoLabel <Label name>
Example : GotoLabel TOP
When this command is executed, Quesdoor will jump to the :TOP
label in the .q-a file as specified with the label command,
and from that point continues with the questionnaire.
Make sure you test everything before bringing the questionnaire
online, because with this command it is very easy to create
endless loops, with only angry users as result.
The command: GOSUBLABEL
-----------------------
Syntax: GosubLabel <Label name>
Example : Gosublabel TOP
When this command is executed, Quesdoor jumps to the :TOP
label in the .q-a file, executes the commands within the label
until the endlabel (':') is encountered, and then continue
normally with the questionnaire.
You can nest a gosublabel (declare a gosublabel inside a
gosublabel) with a maximum of 10 !
The command: START
------------------
Syntax: Start <Questionnaire name> [labelname]
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 21
Example : Start 2EQUES
When this command is executed, Quesdoor will terminate the
current questionnaire and starts the questionnaire 2eques.q-a
(in this example). If you supply the optional [labelname],
QUESDOOR starts the new questionnaire at that label.
The command: ENDIF
------------------
Syntax: EndIf
Example : If 1 = "Q"
GosubLabel dosomething
EndIf
Signifies the end of an IF statement. Whenever you use an
IF command, you must specify an ENDIF statement to let Quesdoor
know it can end the IF command.
The command: ENDNOTIF
---------------------
Syntax: EndNotIf
Example : Ifnot 1 = "Q"
Gosublabel dosomething
EndNotIf
Signifies the end of an IFNOT statement. Whenever you use an
IFNOT command, you must specify an ENDNOTIF statement to let
Quesdoor know it can end the IFNOT command.
The command: IF
---------------
Syntax: If <Var num> = "<String>"
If <Var num1> = <Var num2>
If <Var num1> > <Var num2>
Example 1: If 5 = "Perth"
The IF command compares the contents of the specified
variable number with <String>. If the two do not match,
then all following lines are skipped until an ENDIF statement
is encountered. You must end an IF statement with an ENDIF
before executing a new IF statement (with other words, IF's
cannot be nested).
Example 2: If 1 = 2
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 22
This is an other way of using the IF command. With this way
the IF command compares the contents of variable number 1 with
variable number 2. If the two do not match, then all following
lines are skipped until an ENDIF statement is encountered.
WARNING: Following example only works if the contents of the
used variabelen are numbers (integers)
Example 3: If 1 > 2
This is also possible. If the value of variable number 1 is
bigger than the value of variable number 2 than all following
lines are executed until an ENDIF statement is encountered. If
the value of variable number 1 is smaller (in this example)
than the value of variable number 2 than all lines are
skipped.
The operator (the third word) can be: '=', '<', '>', '>=',
'<=' and '<>'.
The command: IFNOT
------------------
Syntax: Ifnot <var num> = "<string>"
Ifnot <var num1> = <var num2>
Ifnot <var num1> > <var num2>
Example 1: Ifnot 5 = "Perth"
(read this as: If variable 5 is not equal to "Perth" then...)
The IFNOT command is the opposite of the IF command. The
IFNOT command compares the contents of the specified
variable number with <String>. If the two do match, then
all following lines are skipped until an ENDNOTIF statement
is encountered. You must end an IFNOT statement with ENDNOTIF
before executing a new IFNOT statement. (With other words:
IFNOT's cannot be nested)
Example 2: Ifnot 1 = 2
The IFNOT command in this example compares the contents of
variable number 1 with variable number 2. If the two do match,
then all following lines are skipped until an ENDNOTIF
statement is encountered. As operator (the third word) are
also possible: '<', '>', '<=', '>=' and '<>', but it's better
to use the If and Endif statements, those are easier to use.
The command: CHECKPHONE
-----------------------
Syntax: CheckPhone <Var num> <Result Var>
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 23
This command will check the phonenumber of a new user with
the phone numbers of the users in the database. <Var num>
must contain the phonenumber of the new user. If somebody
in the users base has the phone number which is in <var num>,
the result var will have a value of '1', if the phonenumber
is not found <result var> has the value of '0'.
Example: :number
Display "Please enter your phonenumber :"
Ask 12 1
Display "Checking phone numbers....|"
CheckPhone 1 2
If 2 = "1"
Display "This phonenumber is invalid....|"
gotolabel number
endif
if 2 = "0"
Display "Correct...|"
endif
This command will check both the homephone and dataphone field
in your users bbs. If the supplied phonenumber in <var num>
is present in either one of them <result var> will contain a '1'.
So don't use this command if you allow more than one family
member as member, or if you allow two people from the same
company as a member (because they probably use the same
dataphonenumber, and <result var> will return a '1'.
The command: READFLAG
---------------------
Syntax: READFLAG <flagset> <var num>
Example: Readflag a8 1
This command can be used to determine if a certain flag of the
user is set to on or off. After the command is executed,
<var num> will have an contents of 'ON' or 'OFF' according to
the <flagset> you supply. (In this example the A8 flag).
The command: READSECURITY
-------------------------
Syntax: Readsecurity <var num>
Example: Readsecurity 1
This command can be used to determine what security level the
user has on the bbs. After the command is executed <var num>
(in this example variable number 1) will have the security
level as contents.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 24
The command: READANSI
---------------------
Syntax: Readansi <var num>
Example: Readansi 1
This command can be used to determine if the current user on
the bbs has the ansi flag enabled. After the command is executed
<var num> will have an contents of 'ON' or 'OFF' according to
the ansi bit in users.bbs. (in this example var number 1)
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 25
The DATABASE concept:
---------------------
Quesdoor has the ability to store the contents of variable
numbers in special databases. The contents of the variables
can be stored in databases so that it is possible to reload
them back in in another questionnaire!
With this it is for example possible to make an advanced
newuser questionnaire and store the users answers in databases.
When some data of the user changes he can restart the ques-
tionaire, the questionnaire reloads his answers, and the user
can change the data instead of answering all the questions
again.
In every database you can only write one contents of a
variable. If you want to store more variable numbers, you
must create more databases. The <database name> in the commands
may be any valid dos name and path, but without extension!
Quesdoor will use '.QDB' as extension for any database.
If the database(s) become huge, the speed to load the data
will become slower. To speed things up, you can index the
database(s) with the INDEXER.EXE program in the DATABASE.ZIP
package which came with Quesdoor. Just run this program in
your nightly event and see the speed increasing.
The following commands will make your life easier when wor-
king with the database functions:
The command: WRITEDATA
----------------------
Syntax: Writedata <database name> <var num>
Example: Writedata test 1
This command will create a database with 'test.qdb' (in this
example) in your messagebase directory, and writes the contents
of var number 1 to that database. If a user had already data
in the database, the contents of <var num> will overwrite the
previous data.
The maximum length the contents of the variable may have is 80
characters, if the contents is longer, it will be truncated.
The command: LOADDATA
---------------------
Syntax: Loaddata <database name> <var num>
Example: Loaddata test 1
This command will try to load data from the database 'test.qdb'
(only in this example) into variable number 1. If a user has
no data from him in the database the contents of var number 1
will be empty.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 26
The command: CHECKDATA
----------------------
Syntax: Checkdata <database name> <var num>
Example: Checkdata test 1
With this command you can check if the user already has data in
the database.
If the user has data in the database, the contents of <var num>
will be a '1' after the check, otherwise it will have a '0' as
contents.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 27
The VOTEDOOR concept:
---------------------
Whenever you use one of the votedoor commands, quesdoor will
make a *.vot file in your messagebase dir. This file contains
all the data votedoor uses, including the percentage of voting
every question gets, and who already voted... This file will
not exceed 40 K.
If you (as a sysop) find offending questions in the database
you can use DELVOTE.EXE to delete a particular question in the
database. DELVOTE.EXE can be found in the votedoor.zip package
included in the release archive from Quesdoor.
The syntax is DELVOTE <vote database name>, and the program will
show every question, and asks you if it has to delete it.
There is a hard-coded maximum of 19 questions in one votedoor
database. When there are 19 questions in the database, and a
user tries to add a new question, the oldest in the database
will be deleted. When you want more than 19 questions, you
can always use a extra voting database under an other name.
In the votedoor.zip package you will find a ready-to-go
voting door. To install it, simply make a menutype 7 in one
of your menus with as optional data "C:\ra\utils\quesdoor.exe
votedoor". The lay-out and the colours of that voting door are
coded in the questionnaire itself. If you don't like it, feel
free to modify it to your own needs...
The command: ASKQUESTION
------------------------
Syntax: Askquestion <database name>
Example: Askquestion votedoor
In the above example a votedoor.vot database (containing a
maximum of 19 questions = around 40K) will be created in your
message dir. The user will be asked to enter a question and
answers for the voting door. A minimum of 2 answers is
required (maximum of 5). When a empty answer is given the
question will be stored into the database.
The command: SHOWANSWER
-----------------------
Syntax: Showanswer <database name> <question number>/<#var num>
Example 1: Showanswer votedoor 2
When this is used, quesdoor will show the 5 answers with the
percentage of voting from question number 2 in the votedoor
database, and continues with the next command in the
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 28
questionnaire. This command is not used in the sample
votedoor.q-a.
Example 2: Showanswer votedoor #2
And with this the contents of variable number 2 will be
translated into the answernumber to display.
The command: SHOWQUESTION
-------------------------
Syntax: ShowQuestion <database name> [question number]/[#var num]
Example 1: Showquestion votedoor
In the above example all the questions in the votedoor database
will be displayed to the user (the newest first), and continues
with the next command in the questionnaire (should be a "press
enter" prompt).
Example 2: Showquestion votedoor 2
With this, only the second question in the database will be
displayed.
Example 3: Setvar 2 = "3"
Showquestion votedoor #2
And with this, the contents of variable number 2 will be used to
find out which question it has to display. In this example the
contents of the variable is 3, so question number 3 is displayed
only.
Before you invoke this command, you can set the display colour
for ansi users with the CHANGECOLOR command.
The command: VOTEQUESTION
-------------------------
Syntax: Votequestion <database name> [question number]/[#var num]
Example 1: Votequestion votedoor
In the above example every question in the votedoor database
will be shown to the user with the answers, the percentage of
voting, and the user who posted the question. After every
question the user is prompted for a vote. Enter will bring
him to the next question, and Q will continue with the next
command in the questionnaire.
Example 2: Votequestion votedoor 2
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 29
In this example only question number 2 will be shown to the
user. The question with the answers will be shown, but not the
percentage of voting. The user has to vote on the question,
enter or "q" will not work. Before you invoke this command,
you can set the display colour for ansi users with the
CHANGECOLOR command.
Example 3: Votequestion votedoor #2
In this example the contents of variable number 2 will be
translated into the question it has to display and let the
user vote on.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 30
The TIMEBANK concept:
---------------------
The timebank commands will turn Quesdoor in a complete
banking system. Whenever you use one of these timebank
commands, quesdoor will make a quesbank.dat file in your
messagebase directory. This file contains all the data
the timebank uses.
In the timebank.zip package you will find a ready-to-go
timebank door. To install it, simply make a menutype 7 in
one of your menus with as optional data
"C:\ra\utils\quesdoor.exe timebank". The lay-out and the
colours of that timebank door are coded in the questionnaire
itself. If you don't like it, feel free to modify it to your
own needs...
The command: BORROWTIME
-----------------------
Syntax: Borrowtime <max time a user can borrow> [interest]
Example: Borrowtime 30 10
Whenever this command is used the user will be prompted with
how much time he wants to lend from the bank. (In this example
a user can borrow a maximum of 30 minutes).
In this example the optional [interest] is specified at 10%.
If a user loans 30 minutes, he has to pay back an additional
10 percent extra. (so 33 minutes)
A user can only loan once, after that, every deposit he makes
will be directly transferred in paying off his dept. After
paying of his dept completely, the user can borrow again, or
just deposit in his account to save for later use.
The command: BUYTICKET
----------------------
Syntax: Buyticket <price ticket> <max> <total> <price>
<price ticket> = The price one single ticket costs.
<max> = The maximum amount of tickets one
person can buy.
<total> = The total amount of tickets which
have to be sold before a lucky
winner is picked.
<price> = Is the price in minutes the holder
of the winning ticket gets in his
account.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 31
Example: Buyticket 5 2 15 60
With this command the user will be prompted if he wants to
buy a lottery ticket. In the above example the tickets cost
5 minutes each, and a user can buy a maximum of 2 tickets.
When there are 15 tickets sold (in this example) a lucky
winner will be picked automaticly. The winner will receive
60 minutes in his account, and all sold tickets are invalid.
Needless to say that if a user has not enough time in his
account that quesdoor will refuse the buy of the ticket.
The command: DEPOSTIME
----------------------
Syntax: Depostime [max in account]
Example: Depostime 120
When this command is used, the user is prompted on how much
time he wants to deposit in his account. That amount will be
subtracted from his time left for this session and will be
stored in his account.
When the optional [max in account] is specified, the users
can't have more time stored in his account than that amount,
and quesdoor will refuse to deposit more.
The command: REDRAWTIME
-----------------------
Syntax: Redrawtime
Example: Redrawtime
This command will prompt the user on how much time he wants to
redraw from his account. That amount is subtracted from his
account, and the user will have that more time left for this
session.
Quesdoor will monitor your events, so a user is not allowed
to redraw time over your next system event.
The command: ROBBANK
--------------------
Syntax: Robbank <percentage>
Example: Robbank 50
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 32
When this command is used, the user has the option of robbing
the bank! There is a (hardcoded) 10% change that the user
actually succeeds with this robbery, and than the user gets
(in this example) 50% of the amount stored in all accounts.
When the robbery succeeds, the robber gets the <percentage>
of the amount stored in all accounts. Everyone who has an
account will be notified who the robber was, and how much
they lost.
When the robbery fails, the robber looses his account at the
bank, as well as all his time left for this day at the bbs!
The command: SHOWACCOUNT
------------------------
Syntax: Showaccount
Example: Showaccount
When this command is used, the data of the timebank account
for the user (who is in quesdoor) will be shown, including
time in account, account number, account name, borrowed time
and amount of lottery tickets.
When someone robbed the bank, the user is notified, and the
robber's name is shown, including the lost time. When someone
transferred time into this users account, the user will also be
notified. After notification this particular data will be
cleared.
The best thing you could do is to use this command just after
someone enters the timebank, so he sees the changes made in his
account (if any).
The command: SHOWCLIENTS
------------------------
Syntax: Showclients
Example: Showclients
Whenever this command is used, quesdoor will report the total
amount of time in the bank, the total amount of lottery tickets
already sold, and gives a report of all the accounts in the
bank, including name and time.
The command: TRANSTIME
----------------------
Syntax: TransTime
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 33
Example: Transtime
This command is useful when you want to give your users the
opportunity to transfer some of their time to a friend's
account. The user is prompted for an accountname, and if that
accountname exists, the user will be prompted on how many
minutes he wants to transfer from his account to the other.
The user who gets the transferred time will be notified the
next time when he uses the SHOWACCOUNT command.
ED_BANK.EXE
-----------
Ed_bank.exe is a small utility to edit the quesbank.dat file
which Quesdoor uses to store the data for the timebank. Start
this util in the directory where your quesbank.dat file resists.
Ed_bank will let you edit and delete users records in the
quesbank.dat file, and works very simple. No help needed.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 34
The command: BEEP
-----------------
Syntax: Beep
Example : Beep
Produces a beep on local and the caller's console, and
continues with the next command in the questionnaire.
The command: HALT
-----------------
Syntax: Halt <errorlevel>
Example : Halt 10
Terminates the questionnaire with errorlevel <errorlevel> and
returns to bbs or batchfile.
The command: PAUSE
------------------
Syntax: Pause <seconds>
Example : Pause 10
Pauses 10 seconds (in this example), and than continue
normally with the next command in the questionnaire.
The command: QUIT
-----------------
Syntax: Quit
Example : Quit
Terminates the questionnaire and returns to the BBS.
The command: RUN
----------------
Syntax: Run <path + filename.ext> [control codes] [string]
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 35
Example : Run c:\ra\utils\rur_door.exe *B c:\test.ctl *F
This command will run an external program in a shell while the
user is online. The path + full name of the program must be
specified. A batchfile would be no problem.
Many programs require extra information to be passed on the
command line, so the following control codes may be used. In
each case, the code is replaced by it's value:
*B : User's baud rate, or 0 if local
*F : User's first name
*G : Ansi graphics, 0=off,1=on
*H : Normally the fossil is de-initialised before
running an external program to avoid any possible
conflicts between the Fossil and the program.
Specifying this parameter leaves the fossil "hot"
or active (required with quicked.exe).
*L : User's last name
*T : Time remaining for current call.
*M : Swap Quesdoor to Ems or disk to free up memory.
Besides this command line information that can be
passed, Quesdoor will leave Dorinfo1.def and Exitinfo.bbs
intact, so the calling program still can use them.
Note that the external program must do its own time limit and
carrier detect watchdogging, in the event that the user does
not exit from the program correctly. Note also that it is
impossible to start a second quesdoor in the same dir.
In order to keep compatible with the questionnaire command
language the RUN keyword can be replaced by the EXEC keyword.
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 36
CONTROL CODES
-------------
You can use extended codes in your ascii/ansi files
exactly as you are used to in RemoteAccess. When, during a
DISPLAYFILE command, the interpreter encounters such a code,
a special user or system parameter is inserted. The following
codes are validate in your files:
Character
ASCII# Combination Purpose
------ ----------- -------
01 ^A Wait until the [return] key is pressed
02 ^B Disable aborting with the 'S' key
03 ^C Enable aborting with the 'S' key
04 ^D Enable the 'Continue' prompt
05 ^E Disable the 'continue' prompt
06 ^F * Insert a user parameter
07 ^G Produce a beep on the caller's console
08 ^H Backspace
09 ^I Tab (forward cursor 8 characters)
10 ^J Linefeed
11 ^K * Insert a system parameter
12 ^L Clear Screen
13 ^M Carriage return
16 ^P Pause for one second
24 ^X % Execute a program in a DOS shell
* User Parameter Codes
----------------------
Character
ASCII# Combination Information inserted
------ ----------- --------------------
65 ^FA Users full name
66 ^FB Location
67 ^FC Password
68 ^FD Business/Data phone number
69 ^FE Voice/Home phone number
70 ^FF Date of last call
71 ^FG Time of last call
72 ^FH A Flags setting
73 ^FI B Flags setting
74 ^FJ C Flags setting
75 ^FK D Flags setting
76 ^FL NetMail credit remaining (cents)
77 ^FM Total messages posted
78 ^FN Last message read
79 ^FO Security level
80 ^FP Total calls to the BBS
81 ^FQ Number of uploads
82 ^FR Kilobytes of uploads
83 ^FS Number of downloads
84 ^FT Kilobytes of downloads
85 ^FU Minutes used today
86 ^FV Current screen length
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 37
87 ^FW First name only
88 ^FX ANSI setting (ON/OFF)
89 ^FY "Continue?" prompt setting (ON/OFF)
90 ^FZ Screen clearing (ON/OFF)
48 ^F0 Full screen editor (ON/OFF)
49 ^F1 Quiet/do not disturb mode (ON/OFF)
50 ^F2 Hot-Keys (ON/OFF)
* System Parameter Codes
------------------------
Character
ASCII# Combination Information displayed
------ ----------- ---------------------
65 ^KA Total system calls
66 ^KB Last caller (any line)
67 ^KC Number of active messages
68 ^KD System starting message number
69 ^KE System ending message number
70 ^KF Number of times user has paged sysop
71 ^KG Day of the week (full form)
72 ^KH Number of users in the user file
73 ^KI Time in 24 hour format
74 ^KJ Today's date
@ 75 ^KK Minutes connected this call
76 ^KL Seconds connected (always returns 0)
@ 77 ^KM Minutes used today
78 ^KN Seconds used today (always returns 0)
79 ^KO Minutes remaining today
80 ^KP Seconds remaining today (always 0)
81 ^KQ Daily time limit
82 ^KR Current baud rate
83 ^KS Day of the week (abbreviated form)
84 ^KT Daily download limit (in K)
85 ^KU Minutes until next system event
86 ^KV 24 hour format time of the next event
@ 87 ^KW Line number
@ 88 ^KX TERMINATES THE CALL
@ 89 ^KY Name of current template message area
@ 90 ^KZ Name of current template file area
@ 48 ^K0 Number of msgs in selected msg area
@ 49 ^K1 Number of current template message area
@ 50 ^K2 Number of current template file area
@ = not (yet) implemented
% = Executing a program in a dos shell: This gives you
the ability to run an external program in a Dos
shell whenever Quesdoor encounters a ^X embedded
in a text file. The ^X is followed by the command
line you want to execute, and terminated with the
pipe symbol (|). For example, to run an external
mail checking utility when a user enters quesdoor
you could embed the following in a file you display
with a displayfile command:
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 38
^XC:\ra\utils\mailchek.exe *B *F *L|
Quesdoor would then execute the following dos command:
c:\ra\utils\mailchek.exe 2400 Firstname Lastname
The ^X can only be invoked if you have set AllowFileShells
in Raconfig to yes, because it can be dangerous to use...
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 39
THE LET COMMAND
---------------
With the LET command you can change Quesdoor's internal behaviour.
There are many keywords you can use to change the internal messages,
to set dateformats etc. etc..
Here is a list of them:
keywords VMSG1 - VMSG5 control the votedoor internal messages
keywords TBMSG1 - TBMSG9 control the timebank internal messages
keyword DATEFORM sets the dateform as it is used in Askdate.
keyword ERRORON overrides the message error switch.
(more will be implemented in future versions and on request!)
Here is the syntax and the default internal messages and settings:
------------------------------------------------------------------
LET DATEFORM = <number>
Where number can 1 to 4:
1 sets the dateform as DD/MM/YY (the default)
2 sets the dateform as MM/DD/YY
3 sets the dateform as YY/MM/DD
4 sets the dateform as YY/DD/MM
LET ERRORON = ON (or 'OFF')
When you start Quesdoor, the default is on, but you can set
the error display off with the '/E' parameter. With this keyword
you can set the error display on or off in the questionnaire.
Useful when you want to debug just one part of the file.
LET VMSG1 = <"message">
Default "You already voted on this question!"
LET VMSG2 = <"message">
Default "Sorry, there are no questions yet!"
LET VMSG3 = <"message">
Default "You can add a question now. Enter a empty question to quit."
LET VMSG4 = <"message">
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 40
Default "Maximal 5 answers are possible."
LET VMSG5 = <"message">
Default "Give an empty answer when you want to use less then 5
Answers."
LET TBMSG1 = <"message">
Default "Searching for your record...."
LET TBMSG2 = <"message">
Default "Timebank account for #:"
(The # is translated into the users first and last name)
LET TBMSG3 = <"message">
Default "Total amount of time stored in all acounts: # minutes"
(The # is translated into the total amount of minutes)
LET TBMSG4 = <"message">
Default "How much do you want to deposit:"
LET TBMSG5 = <"message">
Default "Are you sure you want to rob the bank (y/N)"
LET TBMSG6 = <"message">
Default "You were able to rob the bank succesfully and get away."
LET TBMSG7 = <"message">
Default "You managed to rob # percent of all the acounts."
(The # is translated into the percentage you set with the ROBBANK
command.)
LET TBMSG8 = <"message">
Default "Your account has been updated with # minutes."
(The # is translated into the amount of minutes deposited"
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 41
LET TBMSG9 = <"message">
Default "It's time to pick a lucky winner..."
LET TBMSG10 = <"message">
Default "The lottery has # tickets sold, buy one!"
(The # is translated into the number of tickets sold)
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 42
INDEX
-----
----- A -----
aborting 57
according 22, 37-38
account 47, 49, 51, 53, 64
accountname 53
accounts 51
acounts 64
active 56, 59
actual 24
additional 5, 47
adds 28
addvar 2, 28
advanced 39
age 14
agreement 5, 7
allowfileshells 61
alt 8
angry 31
ansi 8, 16, 38, 44, 46,
56-57, 59
answer 18, 24, 42, 64
answernumber 44
answers 24, 39, 42, 44, 46, 64
anywhere 20
appendices 4
application 5
archive 5, 7, 42
area 26, 59
aritmethic 2
ascii 8, 57, 59
askcount 2, 14
askdate 2, 14, 62
askedit 2, 12
askforced 2, 12
asknumber 2, 14
askquestion 4, 42
attached 5
automaticly 24, 49
available 5, 7
----- B -----
background 16
backspace 12, 57
bank 4, 47, 51, 53, 64
banking 47
bar 18
base 5, 7, 37
basis 5, 7
batch 31
batchfile 8, 54, 56
baud 56, 59
baudrates 8
bbs 7-8, 10, 14, 25-26,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 43
bbs (cont) 37-38, 51, 54,
56-57
bbsrules 18
beep 4, 14, 54, 57
beeps 8, 14
behaviour 2, 8, 62
besides 56
bit 8, 38
black 16
blackjack 10
board 1, 5, 14
borrow 47
borrowed 51
borrowtime 4, 47
box 1, 7
bringing 31
bulletin 5
business 57
buy 47, 49, 66
buyticket 4, 47, 49
----- C -----
call 14, 22, 56-57, 59
caller 54, 57, 59
calling 14, 56
calls 57, 59
carriage 18, 57
carrier 8, 56
case 5, 8, 56
changecolor 2, 16, 44, 46
chapters 10, 12
character 14, 16, 18, 57, 59
characters 12, 14, 16, 25-26,
31, 39, 57
charge 5
chars 12
chatmode 8
check 7, 37, 41
checkdata 4, 41
checking 37, 59
checkphone 4, 35, 37
choice 16
clear 57
clearing 18, 59
clearscreen 2, 18
code 27, 56-57
codes 4, 12, 20, 27, 54,
56-57, 59
colour 16, 44, 46
colours 16, 42, 47
column 8, 11
combination 57, 59
command 1-2, 8, 10-12, 14,
16, 18, 20, 22, 24-28,
30-31, 33, 35, 37-39,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 44
command (cont) 41-42, 44,
46-47, 49, 51, 53-54,
56-57, 59, 61-62, 64
commands 2, 4, 8, 10-11, 31,
39, 42, 47
comments 11
commercial 7
compares 33, 35
compatible 8, 10, 56
complete 8, 10, 20, 27, 47
concept 4, 39, 42, 47
conditions 5
config 8, 20
conflicts 56
consequential 5
console 24, 54, 57
contact 7
contain 20, 26, 28, 30, 37
containing 42
contents 2, 12, 14, 18, 20,
22, 24-26, 28, 30, 33, 35,
37-39, 41, 44, 46
control 4, 12, 20, 27, 54,
56-57, 62
converted 26
copy 5, 7
copyright 1
correct 8, 12, 37
correctly 56
cost 49
counts 27
create 10, 31, 39
created 24-25, 42
credit 57
currency 7
current 24-26, 33, 38, 56-57,
59
cursor 57
----- D -----
dangerous 61
dark 16
data 5, 25-26, 39, 41-42, 47,
51, 53, 57
database 4, 37, 39, 41-42, 44
datafield 10
dataphone 25, 37
dataphonenumber 37
date 14, 24, 57, 59
dateform 14, 62
dateformats 62
day 51, 59
debug 62
declaration 28, 30-31
declare 31
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 45
default 10, 14, 62, 64, 66
defaults 16
delete 2, 12, 24, 42, 53
deleted 42
depending 10
depends 5
deposit 47, 49, 64
deposited 64
depostime 4, 49
dept 47
descriptor 22, 24
details 5
detect 8, 56
determine 5, 37-38
developed 5
difference 20
different 14, 16
dir 8, 20, 24-25, 42, 56
direct 5, 7
directly 8, 47
directory 7-8, 20, 39, 47, 53
disable 10, 57
disclaimer 2
disk 2, 20, 24, 56
display 2, 7, 12, 14, 16, 18,
20, 22, 31, 37, 44, 46, 59,
62
displayanyfile 2, 20
displayed 18, 20, 22, 24, 44,
59
displayfile 2, 18, 20, 57, 59
displays 18, 20, 22
distribute 5
distribution 5, 7
disturb 59
divides 30
divvar 2, 30
documentation 5
door 1-2, 4-5, 7-8, 10-12,
14, 16, 18, 20, 22, 24-28,
30-31, 33, 35, 37-39,
41-42, 44, 46-47, 49, 51,
53-54, 56-57, 59, 61-62,
64, 66
doors 8
dorinfo 10, 56
dos 10-11, 20, 39, 57, 59, 61
download 59
driver 8
due 5
dutch 7
----- E -----
easier 35, 39
easy 8, 10, 31
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 46
echo 22, 24
edit 12, 53
editor 8, 59
either 7, 27, 37
embed 59
embedded 59
empty 12, 39, 42, 62, 64
ems 56
enabled 8, 16, 18, 38
enables 10
encountered 31, 33, 35
encounters 8, 57, 59
endif 4, 33, 35, 37
ending 59
endlabel 31
endless 31
endnotif 4, 33, 35
enhanced 8, 10
enter 12, 14, 16, 37, 42, 44,
46, 62
entered 7, 14, 25
enters 51, 59
entitles 5
environment 8
equal 35
eques 33
error 8, 10, 24, 62
errorlevel 54
erroron 62
eurocheque 7
europe 1, 7
european 14
event 5, 39, 49, 56, 59
events 49
exact 8
exactly 14, 31, 57
example 12, 14, 16, 18, 20,
22, 24-28, 30-31, 33, 35,
37-39, 41-42, 44, 46-47,
49, 51, 53-54, 56, 59
exceed 5, 42
excludes 5
exec 4, 56
executable 5
execute 57, 59, 61
executed 12, 26-28, 31, 33,
35, 37-38
executing 26, 33, 35, 59
exist 10, 24
exit 56
exitinfo 10, 56
expected 14, 16
expects 20
express 5, 12
extension 8, 20, 24, 39
external 8, 56, 59
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 47
extra 8, 26, 42, 47, 56
----- F -----
fails 51
family 37
fee 5, 7
feel 42, 47
field 14, 25-26, 37
file 2, 5, 7-8, 18, 20, 24,
31, 42, 47, 53, 59, 62
filename 20, 22, 24, 54
files 8, 10, 20, 30-31, 57
fill 12, 25-26
find 8, 20, 24-25, 42, 44, 47
firstname 61
fitness 5
fixed 18, 22
flag 22, 25, 28, 37-38
flagset 22, 37
flexible 8, 31
followed 20, 24, 59
foreground 16
forever 8
form 5, 7, 14, 59
format 59
formatted 22
forms 14
forward 57
fossil 8, 56
found 8, 37, 42
free 10, 42, 47, 56
friend 53
frontdoor 25
full 8, 12, 27, 56-57, 59
function 8
further 12
future 5, 62
----- G -----
gamble 10
game 10, 25
games 10
generated 7
getchar 2, 16
getchoice 2, 16
gets 12, 42, 47, 51, 53
ghost 14
global 4
go 27, 42, 47
good 8, 11
gosublabel 4, 31, 33
gotolabel 4, 31, 37
graphics 16, 56
group 5
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 48
guess 25
----- H -----
halt 4, 54
hangup 8
hard 42
hardcoded 51
hello 22, 24, 27
help 53
hobbies 24
home 57
homephone 26, 37
hot 56, 59
hour 59
----- I -----
idea 10
ifnot 4, 33, 35
illegal 7
implemented 59, 62
implied 5
impossible 56
incidental 5
included 7, 10, 42
including 5, 10, 14, 42, 51
increasing 39
index 39
indexer 39
info 14
information 2, 5, 56-57, 59
input 2, 12, 14, 16
insert 57
install 7, 10, 42, 47
installing 2, 8, 10
instead 7, 12, 39
integers 14, 28, 35
internal 10, 62
interpreter 8, 12, 57
introduction 2
invalid 8, 14, 37, 49
invoke 8, 44, 46
involve 8
itself 8, 10, 42, 47
----- K -----
keyword 22, 56, 62
----- L -----
labelname 31, 33
labels 4, 31
last 56-57, 59, 64
learn 8
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 49
least 14, 31
leave 11, 56
legal 2, 5, 10, 12, 20
lend 47
length 12, 14, 18, 22, 31,
39, 57
less 8, 64
let 4, 10, 14, 33, 46, 53,
62, 64, 66
letter 7
level 20, 26-27, 37, 57
library 7
license 2, 5
likely 12
limit 56, 59
limitation 5
line 5, 8, 10-11, 18, 22, 26,
56, 59
lines 33, 35
list 20, 27, 62
listanswer 2, 20
listflags 2, 22
listsecurity 2, 20
listtimeleft 2, 20, 22
loaddata 4, 39
loan 47
local 8, 18, 24, 54, 56
location 57
lock 8
logfile 25
long 5, 8, 12, 14, 22
longer 25-26, 31, 39
looks 8, 12, 31
lost 51
lottery 49, 51, 66
lucky 47, 49, 66
----- M -----
match 33, 35
material 5
matters 2
max 12, 14, 25, 47, 49
maximum 14, 31, 39, 42, 47, 49
member 37
memory 10, 56
menu 10, 18
menutype 42, 47
message 7, 10, 24, 26, 42,
57, 59, 62, 64, 66
messagebase 39, 42, 47
messages 10, 57, 59, 62
min 12, 14
minimal 14
minimum 14, 42
minutes 22, 27, 47, 49, 53,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 50
minutes (cont) 57, 59, 64
mode 7, 59
modify 5, 42, 47
multiline 8
mulvar 2, 28
----- N -----
name 5, 10, 12, 18, 20, 24,
27, 31, 39, 41-42, 44, 51,
56-57, 59, 64
nested 33, 35
new 7, 10, 24-26, 30, 33, 35,
37, 42
newuser 10, 24, 39
next 8, 10, 12, 18, 42, 44,
49, 53-54, 59
nightly 39
normally 31, 54, 56
note 26, 56
notification 51
notified 51, 53
num 12, 14, 16, 18, 20, 22,
24-27, 33, 35, 37-39,
41-42, 44
number 5, 7-8, 12, 14, 18,
22, 25-28, 30, 33, 35,
37-39, 42, 44, 46, 51, 57,
59, 62, 66
numbers 22, 28, 30, 35, 37, 39
----- O -----
off 10, 22, 25, 28, 37-38,
47, 56, 59, 62
offending 42
online 11, 31, 56
operate 8
opportunity 53
opposite 28, 35
option 51
optional 10, 16, 18, 27, 33,
42, 47, 49
order 5, 7, 11, 56
otherwise 5, 41
output 2, 22, 24
outputanswer 2, 24
outputlog 2, 25
overwrite 39
----- P -----
package 39, 42, 47
page 2, 4-5, 7-8, 10-12, 14,
16, 18, 20, 22, 24-28,
30-31, 33, 35, 37-39,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 51
page (cont) 41-42, 44,
46-47, 49, 51, 53-54,
56-57, 59, 61-62, 64, 66
paged 59
parameter 26, 56-57, 59, 62
part 7, 62
passed 56
password 57
paste 30
path 8, 10, 20, 39, 54, 56
pause 4, 54, 57
payment 7
percentage 42, 44, 46, 49,
51, 64
performance 5, 8
phone 37, 57
phonenumber 25-26, 37
pipe 59
place 10
point 31
points 8, 11
possible 8, 12, 20, 35, 39,
56, 64
postal 7
posted 44, 57
postinfo 2, 24
powerful 22
preformat 22
press 8, 12, 14, 44
pressed 57
price 5, 47
print 7
printed 24
prints 25
prior 7
problem 8, 56
procedure 4-5
produce 57
program 5, 8, 10-11, 39, 42,
56-57, 59
programming 8, 31
programs 24, 56
prompt 44, 49, 57, 59
prompted 44, 47, 49, 53
provide 5
provided 5, 10, 18, 22, 24
purpose 5, 57
----- Q -----
qdb 39
quesbank 47, 53
quesdoor 1-2, 4-5, 7-8,
10-12, 14, 16, 18, 20, 22,
24-28, 30-31, 33, 35,
37-39, 41-42, 44, 46-47,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 52
quesdoor (cont) 49, 51,
53-54, 56-57, 59, 61-62,
64, 66
questionairs 8, 31
questionnaire 1, 8, 10-12,
24, 26, 31, 33, 39, 42, 44,
47, 54, 56, 62
questions 18, 39, 42, 44, 62
quicked 56
quiet 59
quit 4, 54, 62
quotes 18
----- R -----
ra 1, 8, 10, 18, 20, 25-26,
42, 47, 56, 61
raccess 10
raconfig 8, 20, 61
random 2, 25
rate 56, 59
reacts 12
read 35, 57
readansi 4, 38
readflag 4, 37
readsecurity 4, 37
ready 42, 47
reason 5
record 8, 64
redrawtime 4, 49
refuse 14, 49
refuses 14
register 5
registering 2, 5, 7
registration 5, 7, 12
release 42
reload 39
remain 26
remoteaccess 1, 7, 10, 57
rename 7
replaced 26, 56
replaces 26
report 51
require 56
required 8, 42, 56
reserved 1
resist 7
resists 53
response 12, 16
restart 39
result 28, 30-31, 35, 37
return 14, 18, 37, 57
returns 54, 59
reverse 5
right 22
risk 5
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 53
rob 64
robbank 4, 49, 64
robbery 51
robbing 51
routines 8, 12
run 4-5, 8, 10, 39, 54, 56, 59
running 56
----- S -----
save 47
screen 2, 18, 20, 22, 24, 57,
59
second 12, 44, 56-57
section 5, 12
security 20, 26-27, 37, 57
sensitive 8, 31
serial 7
session 7, 49
set 5, 8, 10, 14, 22, 25,
27-28, 37, 44, 46, 61-62, 64
setdataphone 2, 25
setflag 2, 25, 28
sethomephone 2, 26
setlevel 2, 26
setparam 2, 26
sets 26, 62
setsecurity 2, 27
settime 2, 27
setting 2, 22, 28, 57, 59
settings 62
setvar 2, 12, 27, 44
share 5, 8
shell 56-57, 59
show 7, 42
showaccount 4, 51, 53
showanswer 4, 42, 44
showclients 4, 51
showing 7
shown 12, 18, 44, 46, 51
showquestion 4, 44
side 18
signifies 33
simultaneously 5
single 47
site 5, 7-8, 16
skipped 33, 35
slower 39
small 7, 25, 53
smaller 35
smart 8
sorry 62
sort 20
space 22
special 5, 10, 39, 57
specified 16, 18, 20, 25, 27,
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 54
specified (cont) 31, 33, 35,
47, 49, 56
speed 39
start 4, 8, 10-12, 22, 24,
26, 31, 33, 53, 56, 62
starting 11, 24, 59
starts 10, 14, 18, 33
statement 33, 35
status 8
store 27, 39, 53
stored 14, 16, 27-28, 30, 39,
42, 49, 51, 64
string 12, 14, 25, 27, 33,
35, 54
style 25
subject 5
subtracted 49
subtracts 28
subvar 2, 28
supplied 7, 20, 27, 37
supply 14, 26-28, 30, 33, 37
support 1, 5
swap 56
switches 7
syntax 12, 14, 16, 18, 20,
22, 24-28, 30-31, 33, 35,
37-39, 41-42, 44, 47, 49,
51, 54, 62
sys 8
sysop 8, 42, 59
system 7, 47, 49, 57, 59
systems 5, 8
----- T -----
tab 57
telephone 14
template 26, 59
temporary 10
terminate 33
terminated 59
terminates 54, 59
terms 2, 5
text 16, 18, 20, 22, 59
textfile 20
ticket 47, 49
tickets 47, 49, 51, 66
till 14
time 8, 10, 12, 22, 24, 27,
47, 49, 51, 53, 56-57, 59,
64, 66
timebank 4, 10, 47, 51, 53,
62, 64
timer 8
times 11, 59
tips 2, 10
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 55
tm 1
today 57, 59
together 30-31
toggle 28
toggled 28
toggleflag 2, 28
toggles 28
top 30-31
total 47, 51, 57, 59, 64
translated 18, 44, 46, 64, 66
transtime 4, 51, 53
trial 5
tries 42
truncated 25-26, 39
type 10, 18, 26
----- U -----
understand 8
unique 7
uniquely 7
uploads 57
used 5, 7, 12, 20, 22, 27,
35, 37-38, 42, 44, 47, 49,
51, 56-57, 59, 62
useful 10, 24, 53, 62
user 8, 12, 14, 16, 18,
24-28, 37-39, 41-42, 44,
46-47, 49, 51, 53, 56-57, 59
users 7, 12, 18, 20, 22,
25-28, 31, 37-39, 44, 46,
49, 51, 53, 57, 59, 64
usually 8
util 53
utility 53, 59
utils 42, 47, 56, 61
----- V -----
valid 7-8, 11-12, 16, 28, 30,
39
validate 57
value 14, 25, 28, 35, 37, 56
values 12
variabelen 35
variable 8, 12, 14, 16, 18,
20, 22, 24-28, 30, 33, 35,
37, 39, 44, 46
varnum 30
version 5, 10
vertical 18
voice 57
vot 42
vote 42, 44, 46
votedoor 4, 42, 44, 46, 62
voting 4, 10, 42, 44, 46
InterSoft - QUESDOOR - The Extended Questionaire Language Door - Page 56
----- W -----
wait 57
waits 12, 14, 16
watchdog 8
week 59
winner 47, 49, 66
wish 5, 11
word 26, 35
words 33, 35
works 35, 53
write 8, 22, 39
writedata 4, 39
writes 39
written 7
----- Y -----
year 11, 14
----- Z -----
zip 39, 42, 47
